Revamp #106
Revamp #106
Conversation
blankRiot96
commented
Sep 8, 2024
blankRiot96
commented
- Changed content structure
- Added 'what is pygame' page
guide/intro/chapter-1/index.html
Outdated
| <!-- | ||
| To be filled by javascript | ||
| --> |
There was a problem hiding this comment.
I'm gonna nitpick the alignment here
guide/intro/chapter-1/index.html
Outdated
| pygame is "a free and open-source cross-platform library for the development | ||
| of multimedia applications like video games using Python". As the |
There was a problem hiding this comment.
You should cite where quotes come from, in this case, it's the pygame(-ce) github readme
guide/intro/chapter-1/index.html
Outdated
| </p> | ||
|
|
||
| <p> | ||
| Pygame provides the very basic utility to draw and manipulate pixels on to |
There was a problem hiding this comment.
Grammar feels off here, have a suggestion
| Pygame provides the very basic utility to draw and manipulate pixels on to | |
| Pygame aims to be a user-friendly library to draw and manipulate pixels onto |
guide/intro/chapter-1/index.html
Outdated
|
|
||
| <p> | ||
| In this book we'll aim to cover how to do basic things with pygame, with | ||
| little exercises in between to make sure you're not falling off, goodluck |
There was a problem hiding this comment.
the goodluck here seems wrong, here's an approximation of what I would prefer to see
| little exercises in between to make sure you're not falling off, goodluck | |
| little exercises in between to make sure you're not falling off | |
| <b>Good Luck!</b> |
|
|
||
| <h2><a id="pygame-ce" class="js">Pygame-CE</a></h2> | ||
| <p> | ||
| So pygame currently has two major distributors, the original one and a fork |
There was a problem hiding this comment.
Starting a sentence with "So" feels wrong, suggest opening with something different.
| So pygame currently has two major distributors, the original one and a fork | |
| In the event that you weren't aware, pygame currently has two major distributions, the original one and a fork |
There was a problem hiding this comment.
In the event that you weren't aware
I feel like this is too formal? In English it's valid to start sentences with "So" afaik. In formal writing it's frowned upon - but I was trying to go for a more friendly and engaging vibe for the whole article/book. This isn't necessarily unfriendly, of course, but I feel being too formal makes it less engaging
But if we really dont want to move forward with "So", I think we should look for an alternative as "In the event that you weren't aware" feels too formal
I'd say "In case you didn't know, " or just starting off with "Pygame has two major distributions" (but I do feel like adding "So" would be more engaging, we should poll on this maybe)
| <li>Tilemaps: Using Tiled/pytmx vs Making your own level editor</li> | ||
| <li>File structure for larger games</li> | ||
| <li>Code structure for larger games: Paradigms and Techniques</li> | ||
| <li>Utilizing OpenGL with Pygame</li> | ||
| <li>The Text Editor To Choose</li> | ||
| <li>Profiling</li> | ||
| <li>Debugging</li> | ||
| <li>Transferring code across projects</li> |
There was a problem hiding this comment.
Capitalize each word in a title
index.html
Outdated
|
|
||
| <h2>Technical Concepts</h2> | ||
| <ul> | ||
| <li>Blend modes</li> |
index.html
Outdated
| <li><code>display.set_mode</code> flags</li> | ||
| <li><code>sprite</code> API</li> | ||
| <li>Audio API</li> | ||
| <li>Framerate management</li> |
index.html
Outdated
| <a href="/guide/intro/chapter-8/" | ||
| >Chapter 08: The <code>pygame.draw</code> API</a | ||
| > |
There was a problem hiding this comment.
| <a href="/guide/intro/chapter-8/" | |
| >Chapter 08: The <code>pygame.draw</code> API</a | |
| > | |
| <a href="/guide/intro/chapter-8/"> | |
| Chapter 08: The <code>pygame.draw</code> API | |
| </a> |
guide/intro/chapter-1/index.html
Outdated
| <p> | ||
| Now that you know what pygame-ce is, let's install it. | ||
|
|
||
| {% highlight python %} |
There was a problem hiding this comment.
This doesn't need python syntax highlighting because it's not valid python code
There was a problem hiding this comment.
You're right, how do I make a simple codeblock without highlighting again? Just {% highlight %}?
There was a problem hiding this comment.
I figured it out, it was the <pre> tag
